home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 301-325 / disk_309 / sksh / install.doc < prev    next >
Text File  |  1992-05-06  |  5KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 Installation Guide to
  17.  
  18.                                         SKSH
  19.  
  20.                            A ksh-like Shell for the Amiga
  21.  
  22.                                      Version 1.3
  23.  
  24.  
  25.                                (Copyright) 1989, 1990
  26.  
  27.                                      Steve Koren
  28.  
  29.                                    January 2, 1990
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           Installing SKsh
  74.  
  75.             This section descibes how  to  install  SKsh.   It  is  vitally
  76.             important that all the steps be performed.  If  they  are  not,
  77.             SKsh will not operate correctly.  In  addition,  SKsh  requires
  78.             version 1.3 of AmigaDos to operate correctly.
  79.  
  80.             Please examine this file for each release, as it may change  at
  81.             any time.
  82.  
  83.  
  84.                1)   First, copy the .skshinit  and  .skshrc  files  to  the
  85.                     's:' directory.  SKsh needs these two  files  to  start
  86.                     correctly.  Their location can be changed  by  changing
  87.                     the SKSH: device (see below).
  88.  
  89.  
  90.                2)   Edit your startup-sequence and insert:
  91.  
  92.                          assign SKSH: s:
  93.  
  94.                     This controls the location in which SKsh looks for  the
  95.                     startup files.
  96.  
  97.  
  98.                3)   Copy the sksh binary  itself  to  a  location  in  your
  99.                     AmigaDos search path.  You can be fairly sure the  'c:'
  100.                     directory  is  in  your  search  path.   If  you   have
  101.                     modified  your  path,  there  may  be  other  potential
  102.                     locations as well.
  103.  
  104.  
  105.                4)   Set the pure bit on the SKsh binary:
  106.  
  107.                          protect c:sksh rep
  108.  
  109.  
  110.                5)   Make sure that 't:' points to a  fast  device  suitable
  111.                     for storing temporary files.  A sub-directory on a  ram
  112.                     disk is best.  For example,
  113.  
  114.                          makedir ram:tmp
  115.                          assign t: ram:tmp
  116.  
  117.                     You will probably want to  insert  some  commands  like
  118.                     these into  your  startup-sequence,  if  they  are  not
  119.                     already there.  SKsh uses  temporary  files  only  when
  120.                     absolutely necessary, but some types of  SKsh  commands
  121.                     will not function properly without  them  (see  command
  122.                     subtitution, for example).
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           SKSH Amiga Shell             Page 2           Installation Guide
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                6)   SKsh needs a stack size of  at  least  15000  bytes  in
  140.                     order to run properly.  You can manually set the  stack
  141.                     size to 15000 bytes using  the  AmigaDos  stack command
  142.                     before you run SKsh, or you can  insert  'stack  15000'
  143.                     into your startup sequence (recommended).   If  you  do
  144.                     not have sufficient stack space, SKsh *will* crash.
  145.  
  146.  
  147.                7)   The following files need to be  copied  to  a  location
  148.                     which  is  in  your  SKsh  search  path  (although  not
  149.                     necessarily in your AmigaDos search path):
  150.  
  151.                          cmp
  152.                          head
  153.                          join
  154.                          strings
  155.                          tail
  156.                          wc
  157.                          window
  158.                          xd
  159.  
  160.                     You can  create  a  directory  called  "sys:bin"  which
  161.                     contains these commands.   The  supplied  .skshrc  file
  162.                     automatically adds this directory to the search path. 
  163.  
  164.  
  165.                8)   This step is optional, but  recommended.   The  default
  166.                     name for the ram disk is "RAM DISK:".  The  space  will
  167.                     make some things difficult to do (but  not  impossible)
  168.                     in SKsh.  I recommend that you change the default  name
  169.                     of the ram disk in your startup-sequence  to  something
  170.                     like the following:
  171.  
  172.                          relabel ram: RAM_DISK
  173.  
  174.                     The  only  difference  is  that  the  space  has   been
  175.                     replaced by an underscore, and it will make  your  life
  176.                     much easier.
  177.  
  178.  
  179.                9)   Insure  that  your  AmigaDos  ENV:  device  is  set  up
  180.                     properly.  If you are not sure how to do this, see  the
  181.                     AmigaDos manual.
  182.  
  183.  
  184.                10)  Lastly, you must have  arp.library  installed  in  your
  185.                     system in the LIBS: directory.  If  you  are  not  sure
  186.                     how to do this, see  the  arp  documentation.   arp  is
  187.                     available on most Amiga BBS systems.   It  is  best  to
  188.                     use the most recent available arp.library,  since  SKsh
  189.                     will not run correctly with some early versions.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           SKSH Amiga Shell             Page 3           Installation Guide
  196.  
  197.  
  198.  
  199.